Tin nhắn token cơ hội

Mô tả API

Lấy dữ liệu tin nhắn theo dõi của AI đối với token có tiềm năng tăng giá trong điều kiện thị trường hiện tại, dựa trên nhiều chiều dữ liệu.

Tình huống sử dụng:

• Truy vấn tin nhắn theo dõi thời gian thực của AI đối với token có cơ hội tăng giá trong điều kiện thị trường hiện tại
• Tìm hiểu hành vi vốn chủ lực (vào lệnh, tăng vị thế, giảm vị thế, thoát hàng, v.v.)

Gợi ý sử dụng:

• Dùng kết hợp với API danh sách token cơ hội; chỉ truy vấn tín hiệu token trong danh sách token cơ hội mới gọi API này

Tần suất cập nhật dữ liệu: mỗi 5 phút

URL yêu cầu

• Phương thức: POST
• Đường dẫn: /open/v1/ai/getChanceCoinMessageList

Tiêu hao điểm tích lũy

• Điểm tích lũy mỗi lần gọi: 5

Điều kiện tiên quyết

Lấy vsTokenId

Điều kiện	Mô tả	Cách lấy
Đã có vsTokenId	Dùng trực tiếp vsTokenId đã cache, không cần truy vấn lại	Tự động lấy từ ngữ cảnh
Chưa có vsTokenId	Gọi API POST /vs-token/list	Gọi API tiên quyết

Tham số yêu cầu

Truyền tham số trong body dưới dạng JSON.

Tên tham số	Kiểu	Bắt buộc	Mô tả
vsTokenId	long	Có	Token ID

Trường phản hồi

Chỉ liệt kê cấu trúc trường trong từng phần tử của mảng data:

Trường	Kiểu	Kiểu thực tế trả về	Mô tả
updateTime	long	long	Thời gian cập nhật (timestamp mili giây)
vsTokenId	long	string	VS Token ID
symbol	string	string	Ký hiệu token
name	string	string	Tên token
chanceMessageType	integer	integer	Loại dự đoán
scoring	number	number	Điểm
grade	integer	integer	Cấp
price	number	string	Giá token
percentChange24h	number	number	Mức tăng/giảm 24 giờ
gains	number	number	Mức tăng
decline	number	number	Mức giảm

Ý nghĩa nghiệp vụ

Trường	Ý nghĩa	Gợi ý sử dụng
chanceMessageType	Loại tin nhắn cơ hội	Xác định loại hành vi vốn chủ lực, như vào lệnh, tăng vị thế, giảm vị thế, thoát hàng, v.v.
scoring	Điểm cơ hội	Điểm tổng hợp của tín hiệu; điểm càng cao thì tín hiệu càng mạnh
grade	Cấp cơ hội	Phân cấp tín hiệu, dùng lọc tín hiệu quan trọng

Ví dụ yêu cầu

{
    "vsTokenId": 23335      // Token ID
}

Ví dụ cURL (Linux/macOS)

curl --location --request POST 'http://${host}/api/open/v1/ai/getChanceCoinMessageList' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: xxxxx' \
--header 'X-TIMESTAMP: xxxxx' \
--header 'X-SIGN: xxxxx' \
--header 'Accept: */*' \
--data-raw '{
    "vsTokenId": 23335
}'

Ví dụ cURL (Windows CMD)

curl --location --request POST "http://${host}/api/open/v1/ai/getChanceCoinMessageList" ^
--header "Content-Type: application/json" ^
--header "X-API-KEY: xxxxx" ^
--header "X-TIMESTAMP: xxxxx" ^
--header "X-SIGN: xxxxx" ^
--header "Accept: */*" ^
--data-raw "{    \"vsTokenId\": 23335}"

Ví dụ phản hồi thành công

{
    "code": 200,
    "message": "success",
    "data": [
        {
            "updateTime": 1773071700000,       // Thời gian cập nhật
            "vsTokenId": "23335",                // VS Token ID
            "symbol": "THE",                      // Ký hiệu token
            "name": "THENA",                      // Tên token
            "chanceMessageType": 30,                    // Loại dự đoán
            "scoring": 0.0,                       // Điểm
            "grade": 2,                           // Cấp
            "price": "0.2742",                    // Giá token
            "percentChange24h": 6.18293206,       // Mức tăng/giảm 24 giờ
            "gains": 5.0743990000000005,          // Mức tăng
            "decline": 0.363108                    // Mức giảm
        },
        {
            "updateTime": 1773016500000,
            "vsTokenId": "23335",
            "symbol": "THE",
            "name": "THENA",
            "chanceMessageType": 5,
            "scoring": 45.0,
            "grade": 2,
            "price": "0.2621",
            "percentChange24h": 0.44075617,
            "gains": 0.0,
            "decline": 0.0
        }
    ],
    "requestId": "xxx-xxx-xxx"
}